该类主要功能是管理设备模型,包括设备的连接和断开,还有设备状态监听的管理。
一、注意事项
SDK stop的时候。会清除所有的XDeviceStateObserver对象,以及断开和设备之间的连接。
二、API 列表
1. 单例对象
+ (instancetype)shareManager;
支持的版本
开始支持的版本:5.0
注意事项
无
输入参数
无
输出参数
具体的接口输出参数描述如下:
类型 | 描述 | 必选 |
---|---|---|
单例对象 | XLinkDataPointManager | 是 |
错误码
无
2. 连接设备
- (``void``)connectDevice:(XDevice *)device;
支持的版本
开始支持的版本:5.0
注意事项
无
输入参数
具体的接口输入参数描述如下:
参数名称 | 类型 | 描述 | 必选 |
---|---|---|---|
device | XDevice | 要连接的设备 | 是 |
输出参数
无
错误码
无
3. 以指定的连接策略连接设备
- (void)connectDevice:(XDevice *)device
withConnectionPolicy:(XDeviceConnectionPolicy)connectionPolicy;
支持的版本
开始支持的版本:5.0
注意事项
无
输入参数
具体的接口输入参数描述如下:
参数名称 | 类型 | 描述 | 必选 |
---|---|---|---|
device | XDevice | 要连接的设备 | 是 |
connectionPolicy | XDeviceConnectionPolicy | 连接策略 | 是 |
输出参数
无
错误码
无
4. 断开连接设备
- (``void``)disconnectDevice:(XDevice *)device;
支持的版本
开始支持的版本:5.0
注意事项
无
输入参数
具体的接口输入参数描述如下:
参数名称 | 类型 | 描述 | 必选 |
---|---|---|---|
device | XDevice | 要断开连接的设备 | 是 |
输出参数
无
错误码
无
5. 断开本地连接设备
- (``void``)disconnectLocalWithDevice:(XDevice *)device;
支持的版本
开始支持的版本:5.0
注意事项
无
输入参数
具体的接口输入参数描述如下:
参数名称 | 类型 | 描述 | 必选 |
---|---|---|---|
device | XDevice | 要断开连接的设备 | 是 |
输出参数
无
错误码
无
6. 添加一个设备状态变化的更新监听
- (``void``)addDeviceStateObserver:(XDeviceStateObserver *)observer;
支持的版本
开始支持的版本:5.0
注意事项
无
输入参数
具体的接口输入参数描述如下:
参数名称 | 类型 | 描述 | 必选 |
---|---|---|---|
observer | XDeviceStateObserver | 设备状态变化的更新监听 | 是 |
输出参数
无
错误码
无
7. 删除一个设备状态变化的更新监听
- (``void``)removeDeviceStateObserver:(XDeviceStateObserver *)observer;
支持的版本
开始支持的版本:5.0
注意事项
无
输入参数
具体的接口输入参数描述如下:
参数名称 | 类型 | 描述 | 必选 |
---|---|---|---|
observer | XDeviceStateObserver | 设备状态变化的更新监听 | 是 |
输出参数
无
错误码
无
8. 删除某个设备的所有状态变化的监听
- (``void``)removeAllDeviceStateObserverWithDevice:(XDevice *)device;
支持的版本
开始支持的版本:5.0
注意事项
无
输入参数
具体的接口输入参数描述如下:
参数名称 | 类型 | 描述 | 必选 |
---|---|---|---|
device | XDevice | 删除设备监听设备实体 | 是 |
输出参数
无
错误码
无
9. 根据产品id和mac地址获取SDK管理的设备实体
- (XDevice *)getDeviceWithMacAddressData:(NSData *)macData
productId:(NSString *)productId;
支持的版本
开始支持的版本:5.0
注意事项
无
输入参数
具体的接口输入参数描述如下:
参数名称 | 类型 | 描述 | 必选 |
---|---|---|---|
macData | NSData | 设备实体的mac地址 | 是 |
productId | NSString | 设备实体的产品id | 是 |
输出参数
具体的接口输出参数描述如下:
类型 | 描述 | 必选 |
---|---|---|
XDevice | 设备实体 | 是 |
错误码
无
10. 根据产品id和mac地址获取SDK管理的设备实体
- (XDevice *)getDeviceWithMacAddressData:(NSData *)macData
productId:(NSString *)productId;
支持的版本
开始支持的版本:5.0
注意事项
无
输入参数
具体的接口输入参数描述如下:
参数名称 | 类型 | 描述 | 必选 |
---|---|---|---|
macStr | NSString | 设备实体的mac地址字符串 | 是 |
productId | NSString | 设备实体的产品id | 是 |
输出参数
具体的接口输出参数描述如下:
类型 | 描述 | 必选 |
---|---|---|
XDevice | 设备实体 | 是 |
错误码
无
11. 根据设备id获取SDK管理的设备实体
- (XDevice *)getDeviceWithDeviceId:(NSUInteger)deviceId;
支持的版本
开始支持的版本:5.0
注意事项
无
输入参数
具体的接口输入参数描述如下:
参数名称 | 类型 | 描述 | 必选 |
---|---|---|---|
deviceId | NSUInteger | 设备id | 是 |
输出参数
具体的接口输出参数描述如下:
类型 | 描述 | 必选 |
---|---|---|
XDevice | 设备实体 | 是 |
错误码
无